Welcome to
RealSystem G2 for JMF
---------------------
Thanks for downloading RealSystem G2 for JMF. We hope you will find it a useful tool in
assisting you in adding G2 Streaming Audio and Streaming Video to your Java Applications
and Applets. The G2 JMF library leverages the RealPlayer G2 Client Core and thus is
capable of playing back any data source served by a G2 Server - including SMIL authored
content and content served from older RealServer 5.0, 4.0 and 3.0 servers.
Just like the RealPlayer G2, the G2 JMF library is capable of playing back streams using
Real Time Streaming Protocol (RTSP) as well as the PNM protocol. G2 can also play back
media from HTTP servers or using the FILE protocol.
G2 can playback an astounding variety of data types including: RealAudio and RealVideo,
RealFlash, RealPix, RealText, AVI, WAV, AU, ASF and a multitude of other third party
data types (check www.real.com for information about acquiring additional datatype
plugins from third party vendors!).
RealSystem G2 for JMF relies on the RealPlayer G2's platform dependant native libraries
to function. Instructions below describe how to download the appropriate RealPlayer binaries
(and JMF binary components) for your platform. Currently, we are only shipping RealPlayer
G2 for the Win32 environent. We are working hard to support other platforms as soon as
possible.
In this release we are supporting only the Javasoft, Netscape and Symantec's JVM based
on JDK 1.1.4, 1.1.5, 1.1.6 or 1.1.7. We do not support G2 JMF on (unreleased) JDK 1.2
at this time.
Please consult the sdk documentation for more detailed technical information.
The following sub-directories should have been created in the RealSystem G2 SDK directory:
jmf\lib Class library (rjmf.jar)
jmf\samples\papplet General purpose sample which demonstrates a variety
of JMF and G2 features. Includes RealNetworks Music
Showcase catalog of sample clip URLs.
jmf\samples\tutorial An incrimental series of 5 tutorials for those
new to the Java Media Framework or RealSystem G2.
Demonstrates G2 specific features of JMF.
jmf\samples\playerapp Basic "Frame" based sample application with control
bar & gain control. Same features as PlayerApplet3.
jmf\samples\playerapplet Contains 3 example applets.
PlayerApplet1 - basic applet with no controls
PlayerApplet2 - adds control bar and gain control
PlayerApplet3 - adds buffering progress bar support
(same as PlayerApp but in an "applet")
jmf\samples\playerstateapp Demonstrates how JMF works by providing individual buttons
for controlling Player state. Includes "Realize", "Prefetch" and
"Start" Buttons. Also lists ControllerEvents while running - an
excellent tool for understanding how JMF works!
To use RealSystem G2 for JMF
Development Environment
1) Install the latest version of the RealPlayer G2 from www.real.com
Download either the Free RealPlayer or the RealPlayer Plus!
Note: If you intend to use JMF applets in the Netscape Browser it
is important that you install the browser before you complete this
step!
2) Download and install Javasofts JMF 1.x. Make sure jmf.jar is in
your CLASSPATH and JMF 1.x DLLs are in your system PATH.
3) Modify your system's CLASSPATH to include rjmf.jar (found in
\rmasdk\jmf\lib).
4) Register RealSystem G2 for JMF with JMF Manager. Execute
the class com.real.util.RJMFConfig.
java com.real.util.RJMFConfig
You should now be able to run any of the samples in \rmasdk\jmf\samples
either with the java.exe interpreter or the appletviewer.
To use RealSystem G2 for JMF in
Netscape browser
1) Install supported Netscape Browser:
Use Navigator 4.04 or greater with the JDK 1.1 support
installed. If you are not sure if your browser has JDK 1.1
support installed you can check the version by selecting the
"Java Console" menu option. If the version is less then 1.1.4
you need to upgrade to a newerv version of Netscape.
As of this time we cannot provide support for running RealSystem
G2 for JMF in IE4. We hope to provide support for this browser
in the near future.
2) If you have not done so, download and install Javasofts JMF 1.x.
3) Install the latest version of the RealPlayer G2 from www.real.com
a) Download either the Free RealPlayer or the RealPlayer Plus!
b) If you are running on Solaris or Mac then the G2 JMF native
components have been installed with the RealPlayer! Skip
to step 2.
c) If you are running on Windows, please run the RealPlayer and
select "Check for Upgrades" in the Help menu. From the list
of available upgrades select RealSystem G2 for JMF Components.
This will download and install G2 JMF binary (platform dependant)
components.
Optionally, you could load the HTML page
\rmasdk\jmf\samples\download.html and click on the link "Download JMF
Plugins for G2". This feature is currently available only on Windows.
This page is also intended as a sample to illustrate how you
would add a link to your own web pages that will allow your users
to download and install the JMF plugin components.
Tech Support Notes:
I) This version of RealSystem G2 for JMF does not include the Javasoft JMF
classes or neccessary support binaries. We are hoping to be be able to
include them in the very near future. To complete Step 2 (in either case
above) in the installation go to
[http://java.sun.com/products/java-media/index.html] and select
Java Media Framework.
II) If you install the Netscape browser and/or Javasoft JMF *after* installing
the RealSystem G2 for JMF Plugins you will need to modify the list of
registered jmf vendors in the jmf.properties file. There can be two
copies of this file on your machine however.
If you are configured to do development work you will find the jmf.properties
file in the same directory as the jmf.jar on your CLASSPATH. In this case,
simply re-exectue step 4 from the instructions for configuring the development
environment.
If you are also configured to use JMF in your Netscape web browser then
there is an additional copy of jmf.properties in \netscape\program\java\classes
along with another copy of jmf.jar. You could simply modify this one to match
the one in your development CLASSPATH, or, simple add the package prefix
"com.real" to the end of the "content.prefixes" property and the
"protocol.prefixes" property. Alternately you could just copy the property file
in your classpath over the one in the netscape Java directory.
III) Right now we can only support Netscape Navigator browsers which include
support for JDK 1.1.4 or greater. We are hoping to release support for Internet
Explorer 4.x in the very near future.